[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
FT_DISPCNT()
Return the number of outstanding calls to DispBegin()
------------------------------------------------------------------------------
Syntax
FT_DispCnt() --> nCount
Arguments
None
Returns
An integer.
Description
Some routines (like exception handlers, for example) must be able to
guarantee that their output makes it to the screen. This can be
difficult if a call to DispBegin() is in effect, because any error
messages will be sent to Clipper's virtual screen buffer instead of
the actual physical screen. This function alleviates the problem by
allowing you to determine if screen output is being buffered, and if
so, how many DispEnd() calls are necessary to flush the buffer.
Although this function does not use "internals" in the conventional
sense, it still makes use of version-specific information in order
to locate the virtual screen buffer. DO NOT attempt to use this
function with any version of Clipper other than 5.01.
Examples
function ErrorHandler()
// Guarantee that the error message will reach the screen
while FT_DispCnt() > 0 ; dispend(); end
// Now it's okay to do the error message
ErrorMessage( "Something terrible has happened" )
return NIL
Source: DISPCNT.ASM
Author: Ted Means
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson